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GETTING STARTED 


1. Turn on power at left rear of Apple user-station. 
2. System will display: 


NESIAR 


CLUSTER/ONE MODEL A NETWORK BOOT 1.0 
STATION ADDRESS nn 
VOLUME TO BOOT: /MAIN/ 


(If your Apple has no autostart ROM, enter C600G 
<return> to get above display.) 


3. Ask your system manager for name of DOS or Pascal 
virtual diskette you can boot. Type its full name, using 
left arrow if necessary to erase displayed prefix and 
any mistyped characters. Press <return>. 


4. See section on DOS or Pascal, as appropriate, to 
CREATE and MOUNT your own virtual diskettes. Then 
proceed as with a stand-alone Apple. 
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COMMAND SYNTAX 


<0-n blanks> <command word>[<1-n blanks> 
<subcommand word>][<1-n blanks> 
<pathname>][<,other fields>] 


1. Acomma must delimit pathname from other fields. 


2. No blanks may be imbedded in a: 
command word 
subcommand word 
other fields 


3. A field may have one of three forms: 
<keyword> (e.g. REPLACE or ALL) 
<keyword> = <value> (e.g. T = D) 
<letter><value> (e.g. D9 for drive 9) 


4. Optional parameters are shown here in square 
brackets —e.g. [usage]. The system assigns default 
values, where meaningful, when optional parameters 
are not specified. 


5. Cluster commands must sometimes be preceded by a 
special character, depending on the language environ- 
ment: 

@ BASIC command level 
<return> CTRL-N Integer BASIC program level 
<return> CTRL-N or 


<return> CHR$ (14) | Applesoft BASIC program level 


nothing Pascal CMD program 
nothing Pascal SENDMSG or NFSCMD 
function 
2 


CLUSTER COMMANDS AND 
PARAMETERS 


access rights 


set of letters from RWECD (read, write, erase, create, and 
delete). May be null. 


BLOAD 
BLOAD pathname [,LOAD = number] 
e loads binary Cluster-file previously saved with BSAVE 


e loads at LOAD address in BLOAD, if present; if not, 
loads at LOAD address in corresponding BSAVE, if 
present; otherwise, loads at FROM address in BSAVE 


e e.g. BLOAD /MAIN/READDATA 


BRUN 
BRUN pathname [,LOAD = number] 


e BLOADS a binary Cluster-file, then executes it starting 
at first address loaded 


ee.g. BRUN /MAIN/READDATA 


BSAVE 


| BSAVE pathname,FROM = number,size [LOAD = number] 


[REPLACE] 


e saves memory image of specified size starting at FROM 
address on binary Cluster-file 


e e.g. BSAVE /MAIN/READDATA,FROM = $800, 
SIZE = 4096.C 


CREATE 

CREATE pathname, type [,size] [,sectors] 
[protection] 

e creates a new Cluster-file 


e e.g. CREATE /MAIN/USERS/NSS/1,T = D,SECTORS = 13, 
PRVPW = JILL,PRVACC = RWE,GRPPW = DAVID, 
GRPACC = R,PUBACC = 


etl 


ee es 


ec A I i 


DELETE 

DELETE pathname 

e deletes a Cluster-file from system 

ee.g. DELETE /MAIN/USERS/NSS/1:JILL 


drive 


Dd, where d=number 
(1-255 for DOS; 4,5,9-12 for Pascal) 


HELP 


HELP [command name] or ? [command name] 


e displays list of commands or syntax of specified 
command 


ee.g. HELP or ? or ? CREATE 


LIST 

LIST [pathname] [, VERBOSE] [,NESTED] 

e lists entries in default or specified directory 

e VERBOSE gives size of each Cluster-file 

e NESTED lists entire hierarchy of subdirectories 
ee.g. LIST /MAIN/USERS,NSS,VERBOSE,NESTED 


LOCK 


LOCK lockname [,usage] 


e locks “‘lockname”’ for exclusive (EXC) or shared (SHR) 
use 


e usage default is EXC 
e e.g. LOCK PETER,SHR 


lockname 
name of lock (same restrictions as name) 


MOUNT 


MOUNT pathname, drive [,usage] 


e establishes correspondence between a virtual diskette 
and drive number d 


e usage default is RO,SHR 
e e.g. MOUNT /MAIN/USERS/NSS/1,D2,RW,EXC 


name 


name of disk unit or Cluster-file. (1-15 characters; no com- 
mas, slashes, colons, returns or unprintable characters; 
imbedded blanks ok; leading and trailing blanks removed 
by the system; first character any acceptable character 


number 


e if decimal: between — 32768 and 32767, inclusive 
e if hex: between $0 and $FFFF, inclusive 


OFF 
OFF 
e initializes user station and BRUNs /MAIN/BOOT 


password 


a secret word used to gain access to protected Cluster- 
files. Same restrictions as name. May be null. 


pathname 


pathname: /unitname/filepath 
or filepath 


filepath: name[:password] [/filepath] 


unitname: 1, 2, or 5 [:password] 
or name [:password] 


e unit 1: left floppy 
e unit 2: right floppy 
e unit 5: hard disk 


e 80 characters max. An initial slash indicates first field 
is a unit name; no initial slash indicates current default 
directory is to be prefixed to pathname. 


e null pathname refers to default directory for PROTECT, 
SHOW PROTECT and LIST commands. SET DIR witha 
null pathname sets the default directory to null. 


PROTECT 
PROTECT [pathname] [,protection] 
e modifies passwords or access rights for a Cluster-file 


e e.g. PROTECT /MAIN/USERS/NSS,PRVPW = JOHN, 
PRVACC = CDRWE,GRPACC = ,PUBACC = 


protection 
protection: protect item [,protection] 


protect item: GRPPW = password 
PRVPW = password 
PUBACC = access rights 
GRPACC = access rights 
PRVACC = access rights 





sectors 
SECTORS = 13 for DOS 3.2.1; SECTORS = 16 for DOS 3.3 
e required when creating DOS type virtual diskettes 


e not allowed for Pascal, binary and directory type 
Cluster-files 


SET DIR 
SET DIR [pathname] 


e sets default directory to specified pathname or to null if 
no pathname is given 


e SET DIR /MAIN/USERS/NSS:JOHN 


SET password 

SET [GRPPW = password] [PRVPW = password] 
e sets default group or private password 

e e.g. SET GRPPW = JILL,PRVPW = DAVID 


SHOW DATE 
SHOW DATE. 
e displays date as MM/DD/YY 


SHOW DIR 
SHOW DIR 
e displays name of current default directory 


SHOW LOCK 

SHOW LOCK lockname 

e lists all stations using specified lockname 
e e.g. SHOW LOCK PETER 


SHOW LOCKS 
SHOW LOCKS 
e displays all locks set at own station 


SHOW MOUNTS 
SHOW MOUNTS 


e gives information on all virtual diskettes mounted at 
own station 


SHOW PROTECTION 
SHOW PROTECTION [pathname] 


e displays group, private and public access rights for 
Cluster-file addressed by pathname or for default direc- 
tory if no pathname specified 








SHOW STATION 
SHOW STATION 
e displays own station number 


SHOW TYPE 
SHOW TYPE drive 


e displays type of virtual diskette mounted on specified 
drive 


e e.g. SHOW TYPE D2 


SHOW VOLS 
SHOW VOLS 


e displays name of system disk units currently 
operational 


size 

SIZE = number[.size-unit] 

(can’t be given for DOS, must be given for binary, 
optional for Pascal. Pascal default is 280.B) 


size-unit: C: character (1 byte) 
S: sector (256 bytes) 
B: block (512 bytes) 
K: 1024 bytes 

default for ‘‘[.size-unit]’ is B. 


type 

T=B_ (binary) 
T=D (DOS) 
T=P_ (Pascal) 
T=Y (directory) 


UNLOCK 


UNLOCK lockname or UNLOCK ALL 


e releases locked usage on a lockname or on all 
locknames currently held 


e e.g. UNLOCK PETER 


UNMOUNT 

UNMOUNT drive or UNMOUNT ALL 
e cancels previous mount(s) 

e e.g. UNMOUNT D9 


usage 


EXC (exclusive) or SHR (shared) 
RO (read only) or RW (read/write) 


ERROR AND INFORMATION 
MESSAGES 


1,/LLEGAL COMMAND 
2,NAME PARAMETER REQUIRED 
3, UNRECOGNIZED PARAMETER 
4,ILLEGAL DRIVE NUMBER 
5, ILLEGAL STATION NUMBER 
6,STATION NUMBER MUST BE HEX (USE $NN) 
8,ILLEGAL TYPE PARAMETER 
9,COMMAND TOO LONG 
19, HELP FILE NOT FOUND 
20, TYPE PARAMETER REQUIRED (T =) 
21,SIZE OUT OF RANGE (<16B or >32767B) 
22,SIZE NOT ALLOWED WITH T=D OR T=Y 
23,SIZE PARAMETER REQUIRED WITH T=B 
24,SIZE OUT OF RANGE (<1C or >48K) 
25,T = D REQUIRES SECTORS = 13 or 16 
29, CURRENTLY MOUNTED OR DEFAULT DIR 
30, DRIVE REQUIRED 
31,IN USE 
32,IN EXC USE 
33,ILLEGAL DISK TYPE 
35,DRIVE OR “ALL” REQUIRED 
36,NOT CURRENTLY MOUNTED 
40,|ILLEGAL LOCK NAME 


a» = 


ERROR AND INFORMATION 
MESSAG ES (continued) 


110,NO ACCESS FOR READ 

111,NO ACCESS FOR WRITE 

112,NO ACCESS FOR APPEND 

113,NO ACCESS FOR ERASE 

114,NO ACCESS FOR CREATE 

115,NO ACCESS FOR DELETE 
116,CANT DELETE NON-EMPTY DIRECTORY 
117,MEMORY FULL 

118,DISK FULL 

119,DIRECTORY FULL 

120,INTERNAL ERROR 
121,UNINITIALIZED DISK 

122,WRONG SOFTWARE VERSION 
123,CLUSTER-FILE ALREADY EXISTS 
124,DISK I/O ERROR 

125,VERIFY FAILED (BAD MEMORY) 
126,DISKETTE WAS CHANGED 
127,BAD DISKETTE FORMAT 

128,BAD UNIT NUMBER IN PATHNAME 
129,DISKETTE WRITE PROTECTED 
130,NEED PRIVATE PASSWORD FOR PROTECT 
131,UNIT NAME NOT FOUND 

133,DISK NOT READY 


DOS—IMMEDIATE EXECUTION 
OF CLUSTER COMMANDS 
System Displays: User Enters: 


1. }or> PR#n (n is slot with net- 
work interface card, 
usually 6) 

2. ]or> <@> command <return> 


e.g. @LIST<return> 


3. Return code and (Steps 2 and 3 may be 
message, repeated indefinitely.) 
e.g. 0,OK 
1,ILLEGAL COMMAND 


DOS—SETTING DRIVES 


To set number of available drives to 255, POKE 255 into 
appropriate address given below: 


Memory Hexadecimal Decimal 


Size Address Address 
48K $A95B 43355 ( — 22181) 
32K $695B 26971 
16K $295B 10587 


41,IN USE F f For example, if memory size is 48K, type: 
42,IN EXC USE File-Server Not Operating PRINT PEEK(— 22181) (Number should be 2) 
45,NOT HELD If the file-server is not operational when you give a POKE — 22181,255 


51,NOT BINARY 

52,NOT PREVIOUSLY SAVED 

53,FROM PARAMETER REQUIRED 

54,SIZE PARAMETER REQUIRED 

55,FILE WAS THERE, REP NOT SPECIFIED 
57,CLUSTER-FILE IS NOT A DIRECTORY 
60,SHOW OPTION NOT RECOGNIZED 
61,DRIVE REQUIRED 

62,NOT CURRENTLY MOUNTED 

64,NO DEFAULT DIRECTORY SET 

65, TYPE = PASCAL 

66, TYPE = DOS 

67, TYPE = BINARY 

68, TYPE = DIRECTORY 

69,UNKNOWN TYPE 

95, UNRECOGNIZABLE NETWORK RESPONSE 
96,NO NETWORK CARD IN SLOT 
97,MEMORY FULL 

98, NETWORK ERROR 

99,USER ABORT 
101,END OF FILE OR RECORD OUT OF RANGE 
102,CLUSTER-FILE NOT FOUND 
103,BAD DELIMITER IN PATHNAME 
104,FILE NAME OR PASSWORD TOO BIG 
105,NO ACCESS FOR READ TO DIRECTORY 
106,NON DIRECTORY FOUND IN PATHNAME 
107,END OF PATHNAME IS A DIRECTORY 
109,ROOT DIR NOT SPECIFIED, NO DEFAULT 


Cluster command, your Apple will hang up. To resume 
local operation, press CTRL-SHIFT-N. It may be 
necessary to remount your virtual diskettes and reset 
your locks when the file server resumes operation. 


Disk Full in Pascal EDIT 


Ask System Manager to use STATION nn command and 
MOUNT another virtual diskette for your station. 


The above addresses are the same for DOS 3.2, 3.2.1 and 
3.0; 





(continued on next page) 








apes” E PROGRAM 


. At Pascal Command level X(ecute volumename:CMD 


i Enter Cluster commands followed by <return> (Do 
NOT precede with @ sign as in DOS immediate 
execution.) 


3. CMD will display return message but not return code. 
4. To exit, hit <return> only. 


PASCAL—LOCAL CMD 
COMMANDS 


SET drive,drive-status 
e Sets drive (D4, D9, or D11) and other member of drive 
pair to R (real) or V (virtual) through default virtual slot 


ee.g. SET D11,V 
Sets drive-pair 11/12 virtual through slot containing a 
network interface card—normally 6 


SET drive,slot 


e Sets drive (D4, D9 or D11) and other member of drive- 
pair to virtual through slot (S1-S7). Slot specified must 
contain a network interface card. 


e e.g. SET D11,S6 
Sets drive-pair 11/12 virtual through slot 6 


SET slot 


e Sets default virtual slot to S$1-S7. Slot specified must 
contain a network interface card. 


ee.g. SET S6 
Sets default virtual slot to 6 


SHOW DRIVES 


e displays for drive-pairs 4/5, 9/10, and 11/12 whether they 
are real or virtual and which slot each virtual drive pair 
is associated with 


SHOW SLOT 


e displays current default slot 
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BOOT PROGRAM 


The Cluster command BRUN 
whenever: 


1. The Cluster command OFF is issued at a user-station. 


2. His typed at the Pascal command level at a user- 
station. 

3. Power is turned on at an Apple user-station with an 
autostart ROM and a network interface card. If there is 
no autostart ROM, type Cn00G to the Apple II Monitor 
prompt, *, where n is the slot containing the network 
card. 

The BOOT program displays the Nestar logo, station 

number in hex, and prompts: VOLUME TO BOOT: /MAIN/. 

Enter the desired pathname. (See GETTING STARTED on 

page 1 of this card). 

The BOOT program acts differently when booting DOS 

and Pascal volumes. 


DOS: 

e mounts requested volume on drive 1, RO, SHR. 

e if there is a language card, loads it with either Integer 
or Applesoft BASIC, whichever is not present in ROM. 

e gives control to DOS which runs HELLO program, if any, 
on booted volume. 

Pascal: 

e mounts requested volume on drive 4, RW, EXC. 

e mounts /MAIN/PASCALJ/LIB on drive 5, RO, SHR, if 
possible. 


e executes SYSTEM.STARTUP program on booted volume, 
if present. Otherwise displays welcome message, date 
and Pascal command line. 


e SYSTEM.MISCINFO and SYSTEM.PASCAL, with ap- 


propriate GOTOXY for type of terminal being used, must 
be on booted volume. 


e SYSTEM.APPLE must be on MAIN/PASCALJ/LIB if it is 
successfully mounted. Otherwise it must be on the 
booted volume. 


IMAIN/BOOT is executed 
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